/*
 *  Copyright (c) 2022-2022 ForteScarlet <ForteScarlet@163.com>
 *
 *  本文件是 simply-robot (或称 simple-robot 3.x 、simbot 3.x ) 的一部分。
 *
 *  simply-robot 是自由软件：你可以再分发之和/或依照由自由软件基金会发布的 GNU 通用公共许可证修改之，无论是版本 3 许可证，还是（按你的决定）任何以后版都可以。
 *
 *  发布 simply-robot 是希望它能有用，但是并无保障;甚至连可销售和符合某个特定的目的都不保证。请参看 GNU 通用公共许可证，了解详情。
 *
 *  你应该随程序获得一份 GNU 通用公共许可证的复本。如果没有，请看:
 *  https://www.gnu.org/licenses
 *  https://www.gnu.org/licenses/gpl-3.0-standalone.html
 *  https://www.gnu.org/licenses/lgpl-3.0-standalone.html
 *
 */

package love.forte.simbot.action


/**
 *
 * 不支持的行为异常。
 * 对于组件，如果一个行为不被支持（例如 [SendSupport]）那么可能会抛出此异常。
 *
 * @author ForteScarlet
 */
public class UnsupportedActionException : ActionException {
    public constructor() : super()
    public constructor(message: String?) : super(message)
    public constructor(message: String?, cause: Throwable?) : super(message, cause)
    public constructor(cause: Throwable?) : super(cause)
}

/**
 * 抛出 [UnsupportedActionException].
 *
 * e.g.
 * ```kotlin
 * actionUnsupported(cause) { "Send message" }
 * ```
 */
public inline fun actionUnsupported(cause: Throwable? = null, block: () -> String): Nothing = throw UnsupportedActionException(block(), cause)